.-
help for ^_pecats^                                                (STB-57: sg152)
.-

Utility to determine names and values of categories of dependent variable
-------------------------------------------------------------------------

    ^_pecats^ [varname] [^if^ exp] [^in^ range]

Description
-----------

^_pecats^ returns the names and values of the categories for models with
ordinal, nominal, or binary outcomes. For ^mlogit^ it indicates the value
of the reference category.

NOTE: If no variable name is specified, ^_pecats^ will use the dependent
variable retrieved from `e(depvar)' and will restrict the sample according
to e(sample).

Returns
-------

r(numcats): scalar value containing number of categories of depvar.

r(refval):  scalar value of the reference category for ^mlogit^.

r(refnm):   local macro with name of the reference category for ^mlogit^.

r(catnms):  local macro with names of categories of the dependent variable.
            For ^mlogit^ the reference category is given last.

r(catnms):  local macro with names of categories of the dependent variable.
            For ^mlogit^ the reference category is given last.

r(catnms8): local macro with names of categories of the dependent variable.
            Value labels longer than 8 characters are truncated to 8
            characters so they can be used as matrix row/column names. For
            ^mlogit^ the reference category is given last.

r(catvals): local macro with values of categories of the dependent variable.
            For ^mlogit^ the reference value is given last.

Examples within a program
-------------------------

    ...
    * `if' is the curret if condition
    _peife `if'
    * the new condition includes "& e(sample)
    local eif "`r(if)'"
    _pecats `e(depvar)' `eif' `in'
    local cnames r(catnms)
    local cvals r(catvals)
    local refval r(refval)

.-
Authors: J. Scott Long - jslong@@indiana.edu
         Jeremy Freese - jfreese@@ssc.wisc.edu
         www.indiana.edu/~jsl650/
